<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="UTF-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
	<title>地理位置形状(geo_shape)查询 | ElasticSearch 7.7 权威指南中文版</title>
	<meta name="keywords" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <meta name="description" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <!-- Give IE8 a fighting chance -->
    <!--[if lt IE 9]>
    <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
    <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->
	<link rel="stylesheet" type="text/css" href="../static/styles.css" />
	<script>
	var _link = 'query-dsl-geo-shape-query.html';
    </script>
</head>
<body>
<div class="main-container">
    <section id="content">
        <div class="content-wrapper">
            <section id="guide" lang="zh_cn">
                <div class="container">
                    <div class="row">
                        <div class="col-xs-12 col-sm-8 col-md-8 guide-section">
                            <div style="color:gray; word-break: break-all; font-size:12px;">原英文版地址: <a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.7/query-dsl-geo-shape-query.html" rel="nofollow" target="_blank">https://www.elastic.co/guide/en/elasticsearch/reference/7.7/query-dsl-geo-shape-query.html</a>, 原文档版权归 www.elastic.co 所有<br/>本地英文版地址: <a href="../en/query-dsl-geo-shape-query.html" rel="nofollow" target="_blank">../en/query-dsl-geo-shape-query.html</a></div>
                        <!-- start body -->
                  <div class="page_header">
<strong>重要</strong>: 此版本不会发布额外的bug修复或文档更新。最新信息请参考 <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html" rel="nofollow">当前版本文档</a>。
</div>
<div id="content">
<div class="breadcrumbs">
<span class="breadcrumb-link"><a href="index.html">Elasticsearch 权威指南 [7.7]</a></span>
»
<span class="breadcrumb-link"><a href="query-dsl.html">查询领域特定语言(Query DSL)</a></span>
»
<span class="breadcrumb-link"><a href="geo-queries.html">地理位置(geo)查询</a></span>
»
<span class="breadcrumb-node">地理位置形状(geo_shape)查询</span>
</div>
<div class="navheader">
<span class="prev">
<a href="query-dsl-geo-polygon-query.html">« 地理位置多边形(geo-polygon)查询</a>
</span>
<span class="next">
<a href="shape-queries.html">形状查询 »</a>
</span>
</div>
<div class="section">
<div class="titlepage"><div><div>
<h2 class="title">
<a id="query-dsl-geo-shape-query"></a>地理位置形状(geo_shape)查询
</h2>
</div></div></div>

<p>过滤使用<code class="literal">geo_shape</code>或<code class="literal">geo_point</code>类型索引的文档。</p>
<p>要求映射的数据类型为<a class="xref" href="geo-shape.html" title="Geo-shape datatype"><code class="literal">geo_shape</code></a>或<a class="xref" href="geo-point.html" title="Geo-point datatype"><code class="literal">geo_point</code></a>。</p>
<p>
<code class="literal">geo_shape</code>查询使用与<code class="literal">geo_shape</code>映射相同的网格正方形表示来查找具有与查询形状相交的形状的文档。  

它还将使用为字段映射定义的相同的前缀树(Prefix Tree)配置。
</p>
<p>
该查询支持两种定义查询形状的方法，要么提供完整的形状定义，要么引用另一个索引中预索引的形状的名称。

这两种格式都在下面用例子进行了定义。
</p>
<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="_inline_shape_definition"></a>内联形状定义
</h3>
</div></div></div>
<p>与<code class="literal">geo_shape</code>类型相似，<code class="literal">geo_shape</code>查询使用<a href="http://www.geojson.org" class="ulink" target="_top">GeoJSON</a>来表示形状。</p>
<p>下面创建一个 location 字段为<code class="literal">geo_shape</code>类型的索引，并索引一个文档：</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">PUT /example
{
    "mappings": {
        "properties": {
            "location": {
                "type": "geo_shape"
            }
        }
    }
}

# 新增并索引一个文档
POST /example/_doc?refresh
{
    "name": "Wind &amp; Wetter, Berlin, Germany",
    "location": {
        "type": "point",
        "coordinates": [13.400544, 52.530286]
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/190.console"></div>
<p>下面这个查询将使用Elasticsearch的<code class="literal">envelope</code>GeoJSON扩展查找坐标点：</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /example/_search
{
    "query":{
        "bool": {
            "must": {
                "match_all": {}
            },
            "filter": {
                "geo_shape": {
                    "location": {
                        "shape": {
                            "type": "envelope",
                            "coordinates" : [[13.0, 53.0], [14.0, 52.0]]
                        },
                        "relation": "within"
                    }
                }
            }
        }
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/191.console"></div>
<p>类似地，可以在<code class="literal">geo_point</code>字段上执行上述查询。这里我们建立一个含 geo_point 字段的索引example_points，并索引一个文档：</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">PUT /example_points
{
    "mappings": {
        "properties": {
            "location": {
                "type": "geo_point"
            }
        }
    }
}

# 新增并索引一个文档
PUT /example_points/_doc/1?refresh
{
    "name": "Wind &amp; Wetter, Berlin, Germany",
    "location": [13.400544, 52.530286]
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/192.console"></div>
<p>使用相同的查询，返回具有匹配的<code class="literal">geo_point</code>字段的文档：</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">GET /example_points/_search
{
    "query":{
        "bool": {
            "must": {
                "match_all": {}
            },
            "filter": {
                "geo_shape": {
                    "location": {
                        "shape": {
                            "type": "envelope",
                            "coordinates" : [[13.0, 53.0], [14.0, 52.0]]
                        },
                        "relation": "intersects"
                    }
                }
            }
        }
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/193.console"></div>
执行结果：
<div class="pre_wrapper lang-console-result">
<pre class="programlisting prettyprint lang-console-result">{
  "took" : 17,
  "timed_out" : false,
  "_shards" : {
    "total" : 1,
    "successful" : 1,
    "skipped" : 0,
    "failed" : 0
  },
  "hits" : {
    "total" : {
      "value" : 1,
      "relation" : "eq"
    },
    "max_score" : 1.0,
    "hits" : [
      {
        "_index" : "example_points",
        "_type" : "_doc",
        "_id" : "1",
        "_score" : 1.0,
        "_source" : {
          "name": "Wind &amp; Wetter, Berlin, Germany",
          "location": [13.400544, 52.530286]
        }
      }
    ]
  }
}</pre>
</div>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="_pre_indexed_shape"></a>预索引的形状(pre-indexed shape)
</h3>
</div></div></div>
<p>
该查询还支持使用已经在另一个索引中索引了的形状。

当你有一个预定义的形状列表，并且想使用逻辑名称(例如 <em>New Zealand</em>)引用该列表，而不是每次都必须提供坐标时，特别有用。

在这种情况下，只需提供：
</p>
<div class="ulist itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<code class="literal">id</code> - 预索引形状的文档ID。
</li>
<li class="listitem">
<code class="literal">index</code> - 预索引形状所在的索引的名称。默认为<em>shapes</em>。
</li>
<li class="listitem">
<code class="literal">path</code> - 指定包含预索引形状的路径的字段。默认为<em>shape</em>。
</li>
<li class="listitem">
<code class="literal">routing</code> - 形状文档的路由(如果需要)。
</li>
</ul>
</div>
<p>下面是一个将过滤用于预索引形状的示例。我们先建立一个名为shapes的索引，然后索引一个文档进去，文档ID为deu。这里还用到了最上面建立的example索引。</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">
# 建索引
PUT /shapes
{
    "mappings": {
        "properties": {
            "location": {
                "type": "geo_shape"
            }
        }
    }
}

# 添加并索引一个文档,id为deu
PUT /shapes/_doc/deu
{
    "location": {
        "type": "envelope",
        "coordinates" : [[13.0, 53.0], [14.0, 52.0]]
    }
}

# 搜索
GET /example/_search
{
    "query": {
        "bool": {
            "filter": {
                "geo_shape": {
                    "location": {
                        "indexed_shape": {
                            "index": "shapes",
                            "id": "deu",
                            "path": "location"
                        }
                    }
                }
            }
        }
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/194.console"></div>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="_spatial_relations"></a>空间关系 (spatial relations)
</h3>
</div></div></div>
<p><a class="xref" href="geo-shape.html#spatial-strategy" title="Spatial strategies">geo_shape策略</a>映射参数决定了在搜索时可以使用哪些空间关系运算符。</p>
<p>以下是搜索<code class="literal">geo_shape</code>类型的字段时可用的空间关系运算符的完整列表：</p>
<div class="ulist itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<code class="literal">INTERSECTS</code> - (默认) 返回<code class="literal">geo_shape</code>字段与查询几何形状 相交 的所有文档。
</li>
<li class="listitem">
<code class="literal">DISJOINT</code> - 返回<code class="literal">geo_shape</code>字段与查询几何形状 完全不同 的所有文档。
</li>
<li class="listitem">
<code class="literal">WITHIN</code> - 返回<code class="literal">geo_shape</code>字段 包含于 查询几何形状中的所有文档。
</li>
<li class="listitem">
<code class="literal">CONTAINS</code> - 返回<code class="literal">geo_shape</code>字段 包含 查询几何形状中的所有文档。
</li>
</ul>
</div>
<p>搜索<code class="literal">geo_point</code>类型的字段时，有一个受支持的空间关系运算符：</p>
<div class="ulist itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<code class="literal">INTERSECTS</code> - (默认) 返回<code class="literal">geo_point</code>字段与查询几何形状 相交 的所有文档。
</li>
</ul>
</div>
<h4>
<a id="_ignore_unmapped_4"></a>忽略未映射的字段 (ignore unmapped)
</h4>
<p>
如果<code class="literal">ignore_unmapped</code>选项设置为<code class="literal">true</code>，将忽略未映射的字段，并且此查询不会匹配任何文档。

这在查询可能具有不同映射的多个索引时非常有用。

当设置为<code class="literal">false</code>(默认值)时，如果字段未映射，查询将抛出异常。
</p>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="_shape_types_supported_for_geo_point"></a>geo-point 支持的形状类型
</h3>
</div></div></div>
<p>搜索<code class="literal">geo_point</code>类型的字段时，<b>不</b>支持以下形状类型：</p>
<div class="ulist itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<code class="literal">POINT</code>
</li>
<li class="listitem">
<code class="literal">LINE</code>
</li>
<li class="listitem">
<code class="literal">MULTIPOINT</code>
</li>
<li class="listitem">
<code class="literal">MULTILINE</code>
</li>
</ul>
</div>
</div>

<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="_notes_2"></a>注意
</h3>
</div></div></div>
<div class="ulist itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
如果<a class="xref" href="query-dsl.html#query-dsl-allow-expensive-queries"><code class="literal">search.allow_expensive_queries</code></a>设置为false，则不会对用<a class="xref" href="geo-shape.html#prefix-trees" title="Prefix trees"><code class="literal">PrefixTrees</code></a>实现的地理位置形状执行 geo_shape 查询。
</li>
<li class="listitem">
当数据在<code class="literal">geo_shape</code>字段中作为形状数组进行索引时，这些数组被视为一个形状。因此，下面的两个请求是等效的：
</li>
</ul>
</div>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">PUT /test/_doc/1
{
  "location": [
    {
      "coordinates": [46.25,20.14],
      "type": "point"
    },
    {
      "coordinates": [47.49,19.04],
      "type": "point"
    }
  ]
}

PUT /test/_doc/1
{
  "location":
    {
      "coordinates": [[46.25,20.14],[47.49,19.04]],
      "type": "multipoint"
    }
}</pre>
</div>
<div class="console_widget" data-snippet="snippets/196.console"></div>
</div>

</div>
<div class="navfooter">
<span class="prev">
<a href="query-dsl-geo-polygon-query.html">« 地理位置多边形(geo-polygon)查询</a>
</span>
<span class="next">
<a href="shape-queries.html">形状查询 »</a>
</span>
</div>
</div>

                  <!-- end body -->
                        </div>
                        <div class="col-xs-12 col-sm-4 col-md-4" id="right_col">
                        
                        </div>
                    </div>
                </div>
            </section>
        </div>
    </section>
</div>
<script src="../static/cn.js"></script>
</body>
</html>